home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / audiocddat / CDparseframe.z / CDparseframe
Encoding:
Text File  |  2002-10-03  |  3.5 KB  |  67 lines
  1.  
  2.  
  3.  
  4. CCCCDDDDppppaaaarrrrsssseeeeffffrrrraaaammmmeeee((((3333ddddmmmm))))                                            CCCCDDDDppppaaaarrrrsssseeeeffffrrrraaaammmmeeee((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CDparseframe - parse a frame of CD digital audio data
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ttttyyyyppppeeeessss....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ccccddddaaaauuuuddddiiiioooo....hhhh>>>>
  14.  
  15.      vvvvooooiiiidddd CCCCDDDDppppaaaarrrrsssseeeeffffrrrraaaammmmeeee((((CCCCDDDDPPPPAAAARRRRSSSSEEEERRRR**** ccccddddpppp,,,, CCCCDDDDFFFFRRRRAAAAMMMMEEEE**** ccccddddffffpppp))))
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _c_d_p    A pointer to the target CCCCDDDDPPPPAAAARRRRSSSSEEEERRRR
  19.  
  20.      _c_d_f_p   A pointer to the frame of CD digital audio data to be parsed.
  21.  
  22. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.      CCCCDDDDppppaaaarrrrsssseeeeffffrrrraaaammmmeeee((((3333ddddmmmm)))) parses a frame of digital audio data from a CD such as
  24.      is returned by CCCCDDDDrrrreeeeaaaaddddddddaaaa((((3333ddddmmmm)))).... It determines which subcodes are present in
  25.      the data. If those subcodes have changed since the last frame, then
  26.      CCCCDDDDppppaaaarrrrsssseeeeffffrrrraaaammmmeeee((((3333ddddmmmm)))) executes a callback of the appropriate type [see
  27.      CCCCDDDDaaaaddddddddccccaaaallllllllbbbbaaaacccckkkk((((3333ddddmmmm))))] passing to it the subcode data found in the frame.
  28.  
  29.      Callbacks are only executed when the subcodes change because subcodes
  30.      tend to come and go and calling whenever a particular subcode is seen
  31.      would be unpredictable.  Also several of the subcodes never change on the
  32.      disk but may be repeated thousands of times.  Executing a callback every
  33.      time the same subcode is seen would be very inefficient.  For unchanging
  34.      subcodes, the callback is executed the first time the subcode is seen.  A
  35.      program that wishes to see the data every frame is free to look directly
  36.      into the CCCCDDDDFFFFRRRRAAAAMMMMEEEE structure.
  37.  
  38.      If a _c_d__a_u_d_i_o callback is set, CCCCDDDDppppaaaarrrrsssseeeeffffrrrraaaammmmeeee((((3333ddddmmmm)))) executes that callback
  39.      every frame after byte-swapping and, if the CD indicates it is necessary,
  40.      de-emphasizing the data.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      CDintro(3dm), CDcreateparser(3dm), CDdeleteparser(3dm),
  44.      CDresetparser(3dm), CDaddcallback(3dm), CDopen(3dm), CDclose(3dm),
  45.      CDreadda(3dm), CDseek(3dm), CDseektrack(3dm), CDseekblock(3dm),
  46.      cdframe(4)
  47.  
  48. AAAAUUUUTTTTHHHHOOOORRRR
  49.      Mark Callow
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.